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WHAT IS BOOKI? 



With Booki you can create Books. Real paper books that look good and you can hold in your 
hands. You can also use Booki to produce books in the form of epub (electronic books), PDF, 
Word Processing files, web pages and more... 

Booki is designed to help you produce books, either by yourself or with others. Booki is also a 
modern social environment where you can also discuss your views about producing books, 
seek assistance from others, look for projects to contribute to, seek others to help you, 
translate content and publish completed works. 

Booki also supports the rapid development of content. You can use Booki to develop content 
in intensive 'Book Sprints'. Book Sprints are intensive collaborative events where 6-20 people 
focus on writing a book in 2-5 days. These collaborators might be in the same room or located 
around the net, in either case they work together simultaneously to produce a book rapidly. 

While you can use Booki to support very traditional book authoring processes, Booki was also 
developed to facilitate the accelerated production models enabled by Book Sprints. Hence the 
feature set matches the rapid pace of publishing possible in the modern era of print on 
demand. Using Booki, a book can be created in 2-5 days and then print ready source (book 
formatted PDF) can be generated in another 2-5 minutes, and then uploaded to your favorite 
Print on Demand service. 

Whether you are collaborating, writing in solo, rapidly developing books, or taking your time - 
when you have worked with Booki you will never think of publishing the same way again. 

Booki is Free Software (GPL 2+) and developed by FLOSS Manuals. 
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WHAT CAN I USE BOOKI FOR? 



Booki supports any individual or group that wishes to write a book. Some typical uses of the 
platform might be : 

• Writing books - e.g. a Manual, a Cook Book, a Book about Fishing, a fictional tale. 

• Producing printed books 

• Producing ebooks 

• Writing any content as an individual. 

• Collaboratively authoring content. 

• Rapidly developing content in Book Sprints. 

• Customising existing content to apply to a very specific context. 

• Translating a book into another language. 

SIMPLE USE CASES 

Book Sprint 

I am working for rights of immigrant workers. We need to create a booklet about workers 
rights. I read the (free) FLOSS Manuals online manual on Book Sprints and then organise 5 staff 
to dedicate 3 consecutive days the following week. The first morning we each create an 
account. I have already created the new book, given it an open license, sent the others the 
URL, and prepared the Index. We spend 3 hours discussing the chapters and decide who will 
write what. At lunch on the first day we start writing. We continue to write for the following 2 
days. At the end of the last day we output an A5 book formatted PDF of 110 pages and take 
it to our local printer to make 500 stapled copies. Over the next 2 days peers from other 
offices log in to improve and build upon our work. We make the book formatted PDF freely 
available from our website to read or to print for distribution. Each of the other offices print 
copies locally and distributes them. 

Customising Content 

I am a developer that has contributed to several manuals on Free Software. My specialty is 
Drupal, and I have a client that I have just created a site for using Drupal. I want to create a 
manual for that client so I go to my user page and fork the existing FLOSS Manuals Groups 
manual on Drupal. I now have a standalone version of the manual on my account, any 
alterations I do will not be reflected in the original manual unless I merge the changes up 
stream. I remove several chapters not relevant to the client, add 4 new chapters that are 
specific to the client. I mark the new chapters as a€ceCopyright : all rights reserveda€ and 
private so they are not reusable or seen by anyone else using the system. I write these 
chapters with information that is specific to my client and replace several existing screen 
shots in other chapters with screenshots of my clients site. I export the material to book 
formatted PDF, upload it to lulu.com print on demand service and buy 2 copies of the perfect 
bound book for my client. Later a potential client calls me for a meeting - I use my version of 
the Drupal manual, remove the client sensitive material, upload it, buy it, and bring the book 
to the meeting. 

Translating 



I am a volunteer translator. I want to translate a book on Mexican Cooking from the CookMe 
Group into French. I fork the existing manual from the CookMe Group to my user page. I force 
a machine translation of the content and mark all chapters a€ceto be translateda€. I message 
others subscribed to the Booki French group that I need some help and with 3 others we 
translate the material and mark all the chapters a€ceto be proofeda€ or a€oerequires 
technical proofingaC as we complete them. When we are finished I invite a friend to proof the 
content for us. She takes 1 week, doing it in her spare time. After each chapter is proofed she 
marks them a€oecompletea€. Later I output the translated book to book formatted PDF, 
upload to lulu.com and buy a copy. 

Multiple Formats 

I am an educator and have written a text book on digital design using Booki. While writing I 
kept the book private but invited select users to view the material and leave comments a€" 
this was great feedback for me. Now the book is completed and has been picked up by a 
publisher a€" I output an .odt file from Booki and open this in OpenOffice.org, save to a .doc 
format (the publisher does not know about free software) and send to them. I also negotiated 
a Creative Commons license for the material with the publisher. I release the book on my 
website using the embed api and invite translations. Within 4 weeks there is a completed 
Spanish translation which is uploaded to a print on demand service and sold through my 
website. A Portuguese translation is ready 3 weeks later. After an enthusiastic response to 
the Portuguese translation in Brazil I output the material to multiple column PDF suitable for 
printing on large format newsprint. A school district in Sao Paolo finds a local printer, 
downloads the PDF for free, and produces 1500 copies on newsprint and distributes for free 
around schools a€" this costs the same as printing or buying 30 printed books so I feel good 
and the schools make a huge savings. 

Portability 

I am invited to facilitate a Book Sprint on farming techniques in a remote area. The venue is a 
farm with no internet connectivity. I know a little about how to install web services so I 
download and install Booki on my laptop. At the Book Sprint we have 4 laptops connected to 
the local network version of Booki running on my machine. We write the book in 5 days. We 
output the book formatted PDF from my laptop, print the book at a local printer and 
distribute locally as educational materials. Later I upload the sources to the version of Booki 
running on my own server so others can access and reuse the content as they please. 

Organisational Documentation 

My organisation wants to review and upgrade it's documentation. We have decided to use 
Booki to collaboratively rewrite and update our content. Our IT Guru has installed Booki on our 
server so writers can login and update documentation from any machine. We will use the 
versioning feature to keep track of documentation versions as our docs grow and develop 
over time. When final revisions have been approved they are 'published' to screen readable 
PDF and Book Formatted PDF. The Book Formatted PDF is printed off for our 'official 
documentation' while the Screen readable PDF stored on our server for easy digital access by 
staff. 

Using Booki 

3. Accessing Booki 

4. Navigating Booki 

5. Reading a Book 

6. Creating an Account 

7. My Settings 

8. Joining a Group 

9. Creating a Group 



10. Creating a Book 

11. Importing a Book 

12. Adding a Book to a Group 

13. Creating Chapters & Sections 

14. Editing a Chapter 

15. Creating and editing the Table of Contents 

16. Communication 

17. Publishing 
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ACCESSING BOOKI 



Booki can be accessed in several ways: 

• Firstly, the Booki web page provides hosting for many groups and books and is found at 
http://www. booki. cc. 

• Your organisation may have installed a copy of Booki on their own server. In this case 
access would be made through a url provided by your organisation. 

• Like in the Portability use case outlined in the 'How can I use Booki?" chapter, you 
may have Booki installed on your own computer. In this case you would use the url 
created when you installed Booki. 

Fig: The Booki Home Page 

Once you have arrived the home page, most functions can be accessed via the Menu down 
the left hand side of the window. 

■ 

Fig: The Booki Menu 
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NAVIGATING BOOKI 



Navigation around Booki is pretty easy, on the left hand side of the web page is the menu, 
this is used to access most areas of Booki. When reading a book, there is a table of contents 
running down the left hand side of the reading pane which is used to navigate between 
chapters. 

MENU TOOL-BAR 

b 

About - This is booki's home page 

Books - This link takes you to a List of all books created and stored on the Booki server. 
From here you can click on any book title for reading or editing. 

Groups - This link takes you to a list of all the groups that have been created. From this list 
you can link to the Group-page for any group where you can see a list of all the members of 
the group and all the books that have been added to that group. 



People - Displays a page listing all the people signed up with Booki. Clicking on a person's 
name will take you to their profile page. 

My Profile - loads a page displaying your profile, here you will see lists of books you have 
created or imported, groups you are a member of as well as areas where you can create or 
import new books and create new groups. 

My Settings - Displays a page where you can alter your user settings 

My Books - Loads a list of all the books you have created from scratch or imported. 

My Groups - Displays a list of all the groups you have joined. 



-need to add more- 
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READING A BOOK 



Reading a book that has been created, imported or edited with booki is easy. You don't need 
to create an account to read a book, just follow these simple steps. 

1. Go to the Booki home page www.booki.ee. 

2. Click on Books in the menu running down the left-hand side of the page. 
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3. Click on the title that you would like to read. 

o you are taken to the reading screen for the book. 

4. A list of chapters runs down the side of panel, click on the chapter you want to read. 

o the chapter loads into the main panel of the screen for you to read. 

Because the list of books on the Books page is large, it could be easier to click on Groups 
from the menu and then choose a group from the Groups-list. Finally pick the book you want 
from the Books list on the Group page. 
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USE CASE 

e.g. You are a fan of classic English literature, recently you heard from a friend that a lot of 
literature with expired copyright has been added to Booki by the English Literature group. 
Always in search of a good read, you navigate to www.booki.cc.and once there you click on 
Groups. When the Groups-list is displayed you click on the English Literature group, taking you 
to their Group page. You browse their Book List and notice that they include Alice's 
Adventures in Wonderland. As this was a childhood favourite of yours you click on the Books 
title taking you to it's reading page, you click on Chapter I - Down the Rabbit Hole and start 
reading. 
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CREATING AN ACCOUNT 



After arriving at Booki you will need to create a user account before beginning the creation 
and editing of books. 

Account generation is simple: 

1. On the front page click on Login / Register at the top of the screen. 

2. Under Registration add your desired username, email, password + confirmation and 
then your full name. 

o Your full name is required for registration as it is used for copyright attribution on 
any works you create or contribute to. 

3. click 'Register'. 

4. Booki will generate the account and log you into your User Page. Your user page is also 
accessed through My Profile on the menu. 



USE CASE 

You are a keen gardener and have a lot of knowledge to share, hearing of Booki you decide to 
create an account and write books about gardening. Upon accessing the Booki home page 
you click on the Login / Register link and fill in your Username, E-Mail, Passwords and Full 
Name before clicking Register to complete the process. You are now able to create, import, 
edit and contribute to books on Booki. 
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MY SETTINGS 



Once you have created and account, you can edit your settings, to customise your 
appearance on Booki and to help communication with the members of any groups you may be 
a part of. To view your settings click My Settings on the menu. 

<insert pic of my setings> 

When you first enter this page you will see a generic image in the top left corner along with 
the email and full name you entered when creating your account. 

On the right hand side of the panel you can edit your email and full name if either of those 
were typed in incorrectly or if they change in the future. 

Below your full name is a text box where you can type in a blurb about yourself, and at the 
bottom of the page you can browse your computer for an image to upload for Booki for use in 
your profile. 



Once you have made the changes you want to your settings click Save user profile to save 
your changes. 

The last user setting you can change is found on the My Profile page. Once the page has 
been loaded you will see in the top right hand corner of the page a text box asking What's on 
your mind ? You can click in this box and add any comment about how you are feeling and 
what you are thinking about, then click on Share to save the comment. This now appears 
under your full name on your My Profile page. 



■n 
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JOINING A GROUP 



After joining Booki you may want to jump right in and create a book that will be listed under 
your name. However, Booki has the ability to organise groups together to create books that 
share a common theme or interest. 



One example of a Group would be an Organic Gardening group, the group was formed to write 
books about different aspects of organic gardening.encouraging people to start their own 
organic gardens. Organic Gardeners have joined the group to help contribute their expertise in 
the creation of these books. A selection of titles created by the group may include: Growing 
Vegetables, Creating Your Garden, Composting, Growing Fruit Trees, Pest Control and 
Ornamental Gardens. 

To Join a Group: 

1. Click on Groups in the menu. 

2. Find the group you want to join in the Groups-list and click on it. 

3. On the Group page click on the JOIN THIS GROUP button at the bottom of the main 
panel. 

4. You are added to the group and will see your name appear under the Members list. 

REMOVING YOURSELF FROM A GROUP 

At some point you may want to remove yourself from a group. 

1. Go to the Booki home page and click on the link to the Group that you want to be 
removed from. 

o You can also find the Group from your Profile Page, it will be included in the Group 
list. 

2. On the Group page click on REMOVE ME FROM THIS GROUP. 

o You will be removed from the group and your name will disappear from its 
Members list. 

CASE USE 

As an experienced gardener you have recently heard about Booki and the Organic Gardening 
group through a blog page on a gardening website. You have accessed the Booki web page 
and just finished creating your account and now want to join the Organic Gardening group. 

1. You click on the Groups link in the menu taking you to the Groups-list. 

2. On the Groups-list page, you find the Organic Gardening group and click on its link. 

3. This takes you to the Organic Gardening group page, you click on JOIN THIS GROUP and 
see your name added to the Members list. 
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CREATING A GROUP 



Sometimes the group you want to join isn't there yet, so this is your opportunity to blaze a 
trail and start up a group of your very own. 

1. Click on My Profile in the menu 

• Once the page loads you will see the bottom right section of the page is labelled Create 
new group. 



B 



• In the Group name textbox type in a name for your group and then type in a brief 
description in the What is this group about box below. 

• Be sure that you have everything entered as you want it as currently Booki doesn't let 
you change your settings once the group has been created. 

• Finally click on the Create new group button at the bottom of the page. 

• Your new group will be added to the Groups list on your page and you can click on it to 
take you to the group page. 

USE CASE 

You are a primary school teacher and for a class project you want your students to work 
together creating a Book outlining the results of their research. Your hope is that the finished 
document will able to be used as a learning resource for future classes. To ensure that only 
your class are the editors you decide to create a group that the class will use for their 
project. You log in to Booki and click My Profile in the menu. You enter "Room 4 Class 
Projects" into the Group name text box and then type in "Students from room 4 at Sildale 
Primary School use this group to create Books based on class projects." into the What this 
group is about text area. After clicking Create new group you see the group is now added 
to your groups list. You finally click on the group name "Room 4 Class Projects" which takes 
you to the group page. 

m 
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CREATING A BOOK 



There are two ways to create a project in Booki. The first is to create a new blank book and 
the second is to import a book from Archive.org, WikiBooks or any epub file. In this chapter 
we will look at creating a new blank book and then explore importing books in the following 
chapter. 
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Once a user has created an account they can manage the creation of books from their user 
page. This is as simple as entering the title of the book in the field provided and then choosing 
the desired license from the drop down menu. 

H 

1. Click on My Profile in the Menu to go to your user page. 

2. Under Create new book enter the title for your Book and then select the Licence for 
the book from the Drop-down list. 

o For more info on licences and which ones to use when - see the chapter on 
Licensing. 

3. Once you press Create, the book will then be generated and listed under the Books 
heading on your user page. The book has by default no chapters, sections, or content. 

Note: If you try to create a book with the same title as a book that has already exists, booki 
will add '-/' to the end of the title and try again, then if the new title also already exists it will 
try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

USE CASE 

As an organic gardener you have had a lot of experience growing grapes. After joining the 
Organic Gardening Group you decide to start a book based on your particular experience. You 
access your Profile page via My Profile in the Menu and once the page has loaded you type in 
the title "Growing Vine Fruit " under Create New Book. Because you are passionate about 
organic gardening and want as many resources as possible to be available for people who want 
start organic gardening you decide to use the Creative Commons CC-BY-SA licence. This 
licence allows anyone else to use the text in the book, either just to copy or for use in their 
own creation (for example another book on organic gardening), so long as they cite your book 
as the source of any material used and they also use the CC-BY-SA licence on any works they 
create using material from your book. You now click Create and complete the generation of 
your first book! 



11. 



IMPORTING A BOOK 



Books can be imported from several sources, Archive.org, WikiBooks, and epub files. In 
this chapter we go through each of these scenarios. 

Note: When importing text into Booki from it's respective locations and formats it is important 
to note that the document structure may not be a part of the source file. This would leave 
the entire text in a single chapter which will need to be broken up into its individual chapters 
and Sections once in Booki. 

Note: If you try to create a book with the same title as a book that has already exists then 
Booki will add '-/' to the end of the title and try again, then if the new title also already exists 
it will try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

ARCHIVE.ORG 
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The Internet Archive is a a non-profit digital library storing digitised collections of websites, 
music, moving images, software and books. With its stated mission of "universal access to all 
knowledge ." , its purposes include offering permanent access for researchers, historians, 
scholars, people with disabilities, and the general public to historical collections that exist in 
digital format. 

On your My Profile page under Import from Archive.org enter the Archive id and press 
Import. 

• The Archive id can be found in the Identifier field under the Selected metadata 
section at the bottom of the text's page on Archive.org. 

The text is now imported from Archive.org using Espri and converted into a Booki-zip file (this 
may take a while). Once the process has finished the imported book will be added to the list 
of books on your My Profile page. 

EPUB DOCUMENT 

ePub, short for Electronic Publication is an open standard e-book format, that has the ability 
to optimise the text display for whichever device is viewing the book. Booki has the ability to 
import any document in ePub format (note: although ePub is an open format, not all books 
available in ePub format have open licences so care needs to be taken when choosing to 
import an ePub document that it contains a permissive copyright). 

To import an ePub document, first you need to get the url for the ePub book, then copy it's 
location. 

• On your User page in Booki, paste the ePub url into the Url field under Import epub and 
click Import. 

The text is now imported using Espri and converted into a Booki-zip file (this may take a 
while). Once the process has finished the imported book will be added to the list of books on 
your My Profile page. 

USE CASE 

Archive.org 

You have recently joined the Organic Gardening group and have gone in search for already 
compiled texts that could be used to booster the number books available under Organic 
Gardening. Searching through Archive.org you find a book on gardening from 1847, entitled 
"The Family Kitchen Gardener" by Robert Buist. Due to it's age, you have a suspicion that it 
may pre-date all the chemical methods employed by modern conventional gardening and 
therefore contain natural organic methods for growing edible plants. A brief read confirms this 
suspicion and also reveals that there are areas of the text that could do with tidying up as 
well as some updating for the 21st Century, cementing it as a great candidate for importing to 
Booki. 
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1. You navigate to The Family Kitchen Gardener 's page on Archive.org 
(http://www.archive.org/details/RobertBuiststheFamilyKitchenGardener1847) 

2. You scroll down to the bottom of the page where you find the section called Selected 
metadata. 

3. Here you can see that the Identifyer is: RobertBuiststheFamilyKitchenGardenerl847. You 
copy the Identifier and then go to your My Profile page on Booki. 

4. Under Import from archive.org you paste the Identifier into the Archive id field and 
click on Import. 

5. Booki takes a couple of minutes importing the book and when it is finished you see The 
Family Kitchen Gardener listed under Books on you My Profile page. 

6. You can now click on it's title in the Books list to start reading. 

ePub document 

After importing The Family Kitchen Gardener you have been looking through Project Gutenberg 
(www.gutenberg.org) and have found a book entitled "Culinary Herbs: Their Cultivation 
Harvesting Curing and Uses" by M. G. Kains Originally published in 1912 it contains a lot of 
information not only around growing herbs, but also ways to treat, store and use them and 
provides a fantastic base for a book on organically growing herbs. 

1. After loading your Profile page in Booki, you open a new tab or window in your web 
browser. 

2. In the new Tab/Window you navigate to the home page for Culinary Herbs: Their 
Cultivation Harvesting Curing and Uses (http://www.gutenberg.org/ebooks/21414) 

3. Once here you scroll down to the Download this ebook for free section of the page. 
Under the Computer-generated files list you see two epub versions of the book one with 
pictures and one that is plain text. 

4. Thinking that it would be easier to remove any unneeded or unwanted pictures than to 
add new ones later on, you decide to import the version with pictures. You right-click 
on the main site link in the EPUB with images row of the list and click on copy link 
location (firefox, ...) or... (ie, ...), or... (safari, ...). 

5. Going back to the tab/window containing your profile page you paste the copied link into 
the url textbox under Import epub, then click on Import 

6. Booki takes a couple of minutes importing the book and when it is finished you see 
Culinary Herbs: Their Cultivation Harvesting Curing and Uses listed under Books on you 
My Profile page. 

7. You can now click on the edit link next to it's title in the Books list to start editing the 
newly imported book. 
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ADDING A BOOK TO A GROUP 



Once you have created or imported a book into Booki, it will sit in the Books list on your user 
page. As a member of a group often you will want the book that has been created to sit in 
the Group's list of books as well. 

To add a book you have created or imported to a group: 
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1. On your Profile page, click on the link to the Group you want to add your book to in the 
Groups list. 

o You can also use the Groups link or My Groups link on the Booki home page to 
access a Groups list containing the link to the Group you want to add your book 
to. 

2. Once the Group page has loaded you will see a drop-down list containing the titles of 
books that you have either imported or created. 

3. Click on the list and select the book you want to add to the Group 

4. Now click ADD THIS BOOK TO GROUP 

o Your book now appears under the Books list on the Group page. 

REMOVING A BOOK FROM A GROUP 

At some point you may want to remove a book from a group. On the group's page under the 
Books list you will see a remove link next to your book. Click on the link and your book will 
disappear from the list. 

USE CASE 

As an organic gardener with a lot of experience growing grapes, you have just created a new 
book called Growing Vine Fruit. You now want to add this book to the Organic Gardening 
group, along with two books you have recently imported into Booki {"The Family Kitchen 
Gardener" by Robert Buist and "Culinary Herbs: Their Cultivation Harvesting Curing and Uses " 
by M. G. Kains), not only will it help end readers to find the books, but it will also encourage 
collaboration on the books from other members of the Organic Gardening group. 

1. On your Profile page you click on the Organic Gardening link in the Groups list. 

2. Once the Organic Gardening group page has loaded you click on the drop-down list 
containing the titles of books that you have either imported or created and select 
Growing Vine fruit and click on ADD THIS BOOK TO GROUP. 

3. You Repeat Step 2. for The Family Kitchen Gardener and then Culinary Herbs: Their 
Cultivation Harvesting Curing and Uses. 

4. On the Organic Gardening Group page you now see all three titles added to the Groups 
list. 
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CREATING CHAPTERS & SECTIONS 



Chapters are where the content of your book will reside. Each chapter generally contains 
content on a specific topic or group of topics indicated by its title. In a story or novel each 
chapter often treated like an individual scene in a film, advancing the plot one step closer to 
the climax. 

THE EDITING PAGE 

Once a new book is created click on the edit link next to the title of the new book on your 
Profile page to open the book's Editing page. 

• to open the Editing page for a book someone else has created, click on the Books link in 
the menu, click on the book you want to add a chapter to from the list on the Books 
page and then click on the EDIT link. 
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At the top of the Editing page is the Book's Title. Below the Title, you will see a selection of 
tabs: Chapters, History, Notes and Publish. During the editing phase of our book we will be 
primarily focused on the Chapters tab, this is where you can view the layout of the book and 
then access and edit its individual chapters. The History tab shows a list of all the changes 
made to the book since it's creation. In the Notes tab you can leave notes to yourself or 
other authors about what you want to do with the book or an outline of it's intended 
structure, we will explore this feature further in the Communication Chapter. Once a book 
is finished you can use the Publish tab to export your book to variety of formats including 
Book formatted pdf to send to a commercial printer, epub for use with electronic readers and 
HTML to embed the book into your personal web page (for a full list of publishing options see 
the Publishing Chapter). 

Inside the the Chapters tab, the page is divided into two areas, the top area is the Table of 
contents and the bottom area is called Hold chapters. When a chapter is first created it is 
automatically placed into Hold chapters and stays there until you are ready to publish that 
chapter. Any chapter residing in Hold Chapters will not be visible in you books Reading page 
and will not be included when you publish your book (e.g. creating a book or web formatted 
pdf, or epub) 

CREATING A CHAPTER 

1. In the Chapters tab on the editing page click on NEW CHAPTER at the top or bottom 
of the Table of contents. 

2. The New chapter window opens, enter the Title of your new chapter and click Create 
chapter. 

3. The new chapter is created in the Hold chapters section at the bottom of the Table of 
contents. 

USE CASES 

After adding your new book titled "Growing Vine Fruit" to the Organic Gardening group it is 
now time to create the first chapter for the book. 

1. On your Profile page click on the edit link next to the book title Growing Vine Fruit . 

2. Once the Chapters tab in the Editing page for Growing Vine Fruit opens you click on 
NEW CHAPTER. 

3. When the New chapter window appears you type in "What is Vine Fruit " as the Title 
for your first chapter and then click Create chapter. 

4. The new chapter "What is Vine Fruit " appears in the Hold chapters section at the 
bottom of the Table of contents. 
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EDITING A CHAPTER 



Once you have created chapters, content needs to be added to them in the form of text and 
images. This is where you will be spending most of your time in Booki, writing new chapters, 
reviewing chapters, editing chapters and updating chapters as well as inserting and organising 
images in a chapter. 

ACCESS CHAPTER EDITOR 
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1. First you need to be in the Editing page for the book you are working on. 

2. Make sure the Table of contents is visible by clicking on the Chapters Tab. 

3. Then click on the EDIT link next to the chapter you want to edit. 

4. The Chapter editor opens showing the Chapter Title and any content that has already 
been added. 

MAKING CHANGES TO A CHAPTER 

Once the chapter editor opens, just start typing to write or edit the chapter. If you are 
writing a brand new chapter a good practice is: 

1. Get all your text and ideas typed in first. 

2. Once all your content is in go back and and add the formatting such as headings, bold 
and italic styling, lists, tables, etc. 

3. When you have formatted the chapter go through it and work out where you require 
images and what images you require. 

• It can be useful to add in a little note in the spot where you want to add an image a 
description of the image to be added, e.g. --Insert image showing editing toolbar-- 

--Insert image displaying comment within the text-- 

• Now go and obtain/create the required images and upload them to Booki, before inserting 
them into the chapter. 

• Finish off by reviewing the chapter making sure there are no spelling errors, it makes sense, 
and it is relevant to the intended audience in terms of language and content (i.e. is the book 
aimed at primary school children or at adults who have completed university degrees; 
someone brand new to computers or someone with experience in software development). 
The ins and outs of the Chapter editor and Image management will be explored in the 
Chapters ---insert chapter titles here--- . 

SAVING YOUR WORK 

As with every other software application you need to save your work regularly to avoid losing 
those hours worth of effort due to your laptop battery going flat or some similar incident. 

Booki has three buttons concerning saving your work which are located at the top of the 
Chapter editor. They are Save, Save and continue editing and Cancel. 

Save 

clicking on Save will not only save your changes to the chapter, but will also close the Chapter 
Editor and return you to the Book's Table of contents. 

Save and continue editing 

This button is extremely useful, when it saves your changes it leaves the editor open for you 
to continue making changes to the chapter. This is the button to use regularly to ensure you 
don't lose the changes you have made to the chapter. 

Cancel 

This button is only used if you decide that you don't want to keep the changes that you have 
made to the chapter. 

USE CASE 
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You have created the first few chapters for your book "Growing Vine Fruit" for the Organic 
Gardening group and are now ready to start writing. 

1. On your profile page you click on edit next to Growing Vine Fruit in your Books list. 

2. Once the Table of contents has loaded you click on EDIT next to the introduction 
chapter "What is Vine Fruit? " 

o The text editor loads with the heading What is Vine Fruit displayed. 

3. You begin typing your chapter. 

o Every few minutes you click Save and continue editing to make sure you don't 
loose anything you've written. 

4. After you have all the text typed in that you feel necessary for this chapter you give it 
a brief review adding in any formatting where necessary. 

5. At this point you don't feel the need to add pictures to the Introduction so having 
finished your chapter you click on Save to exit the text editor and save your changes at 
the same time. 

--Need to decide where this last paragraph will go-- 

To change the title of your chapter, double click on the title in the Table of contents page. 
You can now edit your chapter title. Click on 'Save' to keep the changes or 'Cancel' to reject 
them. 

--I am currently thinking it should be in the Creating and Editing the Index chapter-- 
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CREATING AND EDITING THE TABLE 
OF CONTENTS 



Once several chapters have been created and developed, it is time to organise and order your 
Table of Contents. 

ADDING SECTIONS TO YOUR TABLE OF CONTENTS 

On the Book Editing page your newly created chapters will be sitting under the Hold 
chapters section, but before you add your chapters to the Table of contents, you may want 
to create separate sections for these chapters to sit under. The sections could have titles 
such as Introduction, Advanced Features, Appendix, or whatever best suits your content, then 
one or more chapters can be added to each section. 

• As you can see with the Booki User Guide, it has been divided into 3 Sections: 

Introduction, Using Booki and Contributing to Booki. The first section only has 2 chapters 
that introduce the reader to Booki: what is it; what can it do; and where can it be used. 
The second section Using Booki contains the bulk of the chapters and instructs the 
reader how to use the various features of Booki from creating an account through book 
creation and editing to publishing a book. The third and final section Contributing to 
Booki contains a couple of chapters for those interested in helping develop the Booki 
software and Documentation. 

To add sections to a book, first you need to navigate to it's editing page, either via your 
Profile page or use the Books link in the menu to find and work on a book created by 
someone else. 
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1. On the editing page click NEW SECTION at the top or bottom of the Table of 
contents. 

2. The New section window opens, enter the title of your new section and click Create 
section. 

3. The new section is created and placed at the bottom of the Table of contents. 

ORGANISING THE TABLE OF CONTENTS 

Hold Chapters 

Inside a book's Chapters tab, the page is divided into two areas, the top area is the Table of 
contents and the bottom area is called Hold chapters. When a chapter is first created it is 
automatically placed into Hold chapters and stays there until you are ready to publish that 
chapter. Any chapter residing in Hold Chapters will not be visible in you books Reading page 
and will not be included when you publish your book (e.g. creating a book or web formatted 
pdf, or epub) 

Re-ordering Sections and Chapters 

If your sections need to be re-ordered click and hold on the up/down arrow at the left of the 
Section bar you wish to move, then drag the section up or down to get to it's rightful place. If 
you need to delete a section, drag it into the Hold chapters area of the Chapters tab. 

Once the book's sections have been set up you are able to use the same technique to drag 
your chapters from the Hold chapters area into the correct section of the table of contents. 
If there are any chapters you are unsure about or want to make significant modifications to 
you can drag them back to the Hold chapters area so they wont appear in the Table of 
Contents on your Book's Reading Page. 

Deleting Sections and Chapters 

To delete a section, use the above method to move it into Hold Chapters once in there it will 
be deleted. 

Currently chapters can't be deleted from Booki, but to prevent them from appearing in a 
book's Reading page or from being published drag them into Hold Chapters. 

EDITING CHAPTER AND SECTION TITLES 

Once a chapter or section has been created, you may not always like the title or you might be 
re-organising the entire book and therefore chapters and sections need to be re-named for 
the new structure. Renaming is the same for both chapters and sections: 

1. Open your book's Edit page and make sure the Chapters tab is selected. 

2. Double-Click on the chapter or section name that you want to change. 

• A text field opens allowing you to change your title. 

• Make any changes you desire and then click on the SAVE button to the right of the text 
field. 

• CANCEL will of course cancel any changes made and return you to the previous title. 

USE CASE 
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Creating a Section 

After creating a few chapters for Growing Vine Fruit you decide it is time to add some 
structure to the book by dividing it into sections, after some thought you come up with the 
following sections to add to the book: Introduction; Developing Your Soil; Planting and Early 
Growth; Pruning and Mature Growth ; and Harvesting and Propagation . Now you need to add 
these sections to your book 

1. On the Editing page for Growing Vine Fruit you click on NEW SECTION in the Chapters 
tab. 

2. In the New section window you type in "Introduction" and click on Create section. 

3. Introduction appears at the bottom of the Table of contents. 

4. You click on NEW SECTION again and this time type in "Developing Your Soil". 

5. When you click Create section Developing Your Soil appears at the bottom of the 
Table of Contents Below the Introduction section. 

6. You repeat step 4 and 5 for Planting and Early Growth , Pruning and Mature Growth , and 
Harvesting a Propagation . 

Moving Chapters 

Now that the sections have been created you want to move your first chapter "What is Vine 
Fruit" from Hold chapters into the Introduction section. 

1. You hold down the left mouse button on the up/down arrow to the left of the What is 
Vine Fruit chapter title. 

2. You then Drag the chapter from Hold chapters up to the Table of contents and keep 
moving until it is sitting directly below the Introduction section title, before releasing the 
left mouse button. 

3. What is Vine Fruit is now sitting in the Table of contents as the first chapter in the 
Introduction section of your book. 

Renaming a Section 

After placing What is Vine Fruit in the Introduction section you decide that the section title 
Introduction doesn't fit in with your plan for the book and will change it to "Getting to Know 
Vine Fruit" 

1. You double click on the section title "Introduction" 

2. The title bar changes to a text box containing the word Introduction. 

3. You delete Introduction and type Getting to Know Vine Fruit before clicking SAVE. 

4. The title bar returns to normal displaying the new section title Getting to Know Vine 
Fruit. 
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COMMUNICATION 
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When collaborating on a book, communication is a vital part of the process, whether working 
in a book sprint, taking your time on more long-term book generation, working locally in the 
same physical space or remotely online. These situations have different requirements and 
harmonising these into one system is where FLOSS Manuals has done a lot of real world 
research and Booki will take the best of what we have learned. Booki includes tools such as 
real time edit notifications to see who is editing what at this moment, a real time chat (web / 
IRC gateway), system level notifications, chapter status markers, book progress indicators, 
work flow tools, and live user status listing 

REAL TIME EDIT NOTIFICATIONS 

When you have clicked on an edit link for a chapter and someone else enters the books Editing 
screen your user name replaces the EDIT link in the Table of contents. This notification 
happens in real time, if you are looking at the overview screen when someone else clicks the 
edit link for one of its chapters you will see the edit button change to their user name. 

REAL TIME CHAT 

Upon entering a book's Editing screen you will see a chat box for that book. The Chat is 
visible for the duration of the time you are editing the book, regardless of which chapter you 
are working on. Anyone else editing the book also has the chat box and you are able to 
communicate with them by typing directly into the text field under the the chat box. This 
feature is very useful for communication with remote participants in Book Sprints as well as 
any situation where contributors to are book are working on it simultaneously. 

Other information is also communicated through the Chat box. When a contributor enters the 
book editing screen a JOINED marker is displayed along with their name in the Chat box. So 
anyone already editing a book can see that someone else has joined them in editing mode and 
they can start communicating. 

Live User Status Listing 

Below the chat box is a Currently editing panel which lists all authors currently working on the 
book. As an added feature of this panel not only is the users name listed but also a "What's 
on your mind ?" statement, which is edited from your Profile page. This statement can help 
communicate to others what you are working on (e.g. "I'm touching up formatting in the 
Introduction"), or how you are feeling (e.g. "Having bad day, don't want to talk.. .TO ANYONE"). 

SYSTEM LEVEL NOTIFICATION 

System Level Notifications are generated when the following actions are performed: 

• When a user saves a chapter 

• When a user creates a new chapter 

• When a user renames a chapter 

• When a user alters the status of a chapter 

• When a user creates a new section 

• When a book is being published 

• When a user saves a book's notes 

Booki generates and displays the messages in two ways: using the Chat Box and using the 
History Tab in the Editing Page. 

Chat Box 
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When one of the above actions is performed the Chat box displays an INFO marker and brief 
description outlining what has taken place. This Notification is extremely useful in a Book 
Sprint environment where several participants are collaborating on a book simultaneously. 
Each participant is kept up to date of others' progress and can instantly reply to any 
notifications using the Chat Box. 

History Tab 

The History tab sits next to the Chapters tab in the Book Editing Page. Clicking to the 
History tab loads up a list of all the edits that have been made to the book (Note: on a 
mature book it can take a while to load the list due to the large number of edits that have 
been made). Every time one of the above actions is performed a new item is added to the 
history tab using a number code to identify what type of action has taken place. The Date 
and time of the action is also recorded. 

If an edit to a chapter has been very minor, for example a spelling correction, the author has 
the option to prevent a history record from being generated when the chapter is saved. This 
is carried out using the Minor change, don't notify tick box at the bottom of the Chapter 
Editing panel. Placing a tick in the box will prevent a history record from being generated 
when the chapter is saved. 

An author also has the ability to add comments to the history record using three text boxes 
below the Minor change, don't notify tick box. The top box is a general comment box, 
followed by an Author text box, where the Author has the option of entering their name. 
The final text box is an Author comment box where the author is able to make another 
note. Comments entered into any of these text boxes will be added to a history record when 
the chapter is saved. 

The records in the history tab can be very useful for working on a book over a long period of 
time where contributing authors are often not logged into Booki at the same time. It can 
display what edits other authors have contributed since the last time a participant logged on 
and help them to decide what areas to work on. This is especially true if the author has added 
comments detailing what they did and what further work they feel is needed in order to 
complete the chapter they have contributed to. 

CHAPTER STATUS MARKERS 

In the Chapters tab of the book editing page, on the right hand side of each chapter bar there 
is a status marker for the chapter. 

This can be manually altered depending on what stage the chapter is up to. Clicking on the 
marker reveals a drop-down list. Click on the list and select the status required for the 
chapter. The chapter's marker is changed to the new status. 

When working on a book that has been created from scratch, the default marker is not 
published. For a book that has been imported from another source, the default status for a 
chapter is imported even for new chapters that have been created from scratch after the 
import. 

BOOK NOTES 
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A books notes are where contributors can discuss and add comments about the book as a 
whole. Anything can be added to a book's notes including a suggested structure or outline for 
a book, which areas need urgent attention and even suggestions for a books direction. Book 
Notes are accessed through the Notes tab on the Book Editing Page. Once there you have a 
free text field to add a much or as little as you want. When you have added your notes, click 
Save the notes at the bottom of the Notes tab to save your changes, an INFO notification will 
be displayed in the Chat box saying that the notes have been saved. 

USE CASE 

You log into Booki to make some additions to your book "Growing Vine Fruit", when you load 
up the Editing page you notice that another member of the Organic Gardening Group is 
already editing a chapter on Pruning as their name appears instead of the Edit Button for the 
Pruning chapter in the Table of contents. You use the chat bot to hi to the other Author and 
two of you have a brief conversation about the structure of the book before start on your 
own edits. 

While you are typing away you suddenly see an INFO icon pop up in the Chat box saying that 
the other Author has saved the chapter "Pruning". A couple of minutes later you see their 
name disappear from the Currently editing panel below the Chat box, this reminds you of 
some ideas that came up in the conversation you had earlier. You think these would be good 
to share with everyone working on "Growing Vine Fruit" so you save your work and then click 
on the Notes tab. In the notes tab you type in a couple of sentences outlining a revised 
structure for the book. Now any other Author will be able to click on the notes tab to find out 
the proposed structure for the book and even make their own notes or additions. 



17. 



PUBLISHING 



Once a book has been completed or finished to a satisfactory level it can be published. 
Publishing can be sent to several different outputs - not just to standard print formats - each 
with it's own specific needs and uses. 

PUBLISHING FORMATS 

book formatted pdf - book(PDF) 

Used for the creation of printed books, the book(PDF) file can be uploaded to a print on 
demand service or even sent to a local printer for printing of a standard bound book. It can 
also be used for printing a single copy of a book from a domestic printer. 

newspaper formatted pdf - newspaper(PDF) 

This format is used for printing multicolumn texts to large scale newsprint. This can be useful 
for cheaply printing off books using a cheap print format and local printers. 

web formatted pdf - web(PDF) 

This type of production is to be read on screen. It can be added to a website, or downloaded 
for off-line viewing on a computer or any compatible device. 

epub 
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epub is used for e-book publication, it generates and e-book using the open epub format. 
Which can be read using any compatible device, including computers with appropriate software 
as well as portable devices such as the Sony Reader and Apple's iPod Touch and iPhone. 

OpenOffice Rich Text format (.odt) 

This output can be opened and edited in OpenOffice.org, enabling extra customisations to be 
added as well as conversion to Microsoft's .doc format for exchange with 3rd parties who 
haven't heard of free software. 

HTML 

the HTML output can be embedded into any website, so an organisation is able to export a 
book to HTML and then embed it into their website. 

PUBLISHING A BOOK 

Once a book is ready from the Book page, click on the Publish tab. You can now set the 
publishing options for your book. 

Simple publication 

If you are happy with just a generic look and feel for your book and your aren't planning on 
selling copies to retail book stores, then all you need is a simple publication. 

1. Enter a Title for your printed book. 

2. by default this is the title used within Booki but it can be changed if required and forms 
the Title Page or cover for the book. 

3. Choose the output document type from the drop-down list. 

4. Choose a licence for the book from the drop-down list. 

5. Place a tick next to archive.org if you want a copy of your book sent there. 

6. Click on Publish this book 

Booki will convert your book to the desired document type using objavi and when finished will 
display a link to the generated document. The page size for your book will be Comicbook which 
is 160mm x 260mm and you use a default style set for your fonts and layout. 

Advanced options 

Clicking on Show advanced options reveals a range of extra settings that can be used to 
customise the output of your book. 

• If you have purchased an ISBN number for your book, you are able to add it using the 
advanced options. 

• A Table of Contents header can be added to your book. 

• You can set the size of your book, there is a pre-set list of sizes as well as the ability to 
enter custom Width, Height, Margins, Gutter, Columns and Column Margins. 

• You are able to set the style for you book using CSS mode. You can select either 
Server default or custom. With custom selected a text box is displayed where you are 
able to edit and modify the CSS used to generate your book. 

• At the bottom of the advanced options you can select Grey-scale for use when printing 
with only black and white such as printing to newsprint. 

Contributing to Booki 

18. How We Work 

19. Bug Reporting 
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HOW WE WORK 



We are happy to extend our core team in time to include others that are enthusiastic about 
the project and can commit the time and energy. Currently we are a small team consisting of 
just the following members : 

Adam Hyde - Project Manager 
Aleksandar ErakoviA}: - Progammer (Booki) 
Douglas Bagnall - Programmer (Espri, Objavi) 

There are several others involved such as Jan Gerber and Andy Cat. We also work closely with 
the Archive.org team on several issues including epub import and export of content directly to 
the Archive.org servers. 

The development of the FLOSS Manuals platform was really a process of experiencing first 
hand what is needed to develop Free Software manuals through two processes : 

1. Community and individual writing of documentation 

2. Book Sprints 

With FLOSS Manuals the team would work with the community and Book Sprint teams 
creating documentation and then discuss what works and doesn't work and extend the 
platform accordingly. Sometimes this was done with the assistance of project funding, and 
sometimes without. In all cases we preferred (and still do) utility over complicated design. KISS. 

We have now ceased work on the FLOSS Manuals platform to develop Booki and I think its fair 
to say that while the FM platform is fully functional and productive, we see it not as a 'finished' 
work but as a prototype and our primary feature-set design document for the current Booki 
development. 

This short pre-history also explains our preferred development methodology. Although we do 
have milestones and we have a pretty clear idea of what we want to build, much of the detail 
and new ideas are worked out in discussion in IRC. If you wish to contribute to the code base 
then the process of getting involved is more about engaging with the resources listed below 
and asking questions than it is about reading our (non-existing) design documentation. 

If you wish to help fix existing features please look at the Trac tickets. 

You can also read the section 'How You Can Help' if you wish to tackle implementing new 
features. 

The following are the main channels for communication and for getting the code. 

RESOURCES 

IRC : irc.freenode.net #fm-tech 

Email : http://lists.flossmanuals.net/listinfo.cgi/booki-dev-flossmanuals.net 

Code 

http://booki-dev.flossmanuals.net/git 

Here you will find the repositories for Booki, Objavi and Espri 
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Trac 

http://booki-dev.flossmanuals.net/ 
Primary Install 

http://www.booki.cc 

FLOSS Manuals 

http://www.flossmanuals.net 
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BUG REPORTING 



Bug Reporting - believe it or not, there are people out there that love bug reporting. If you are 
one of those people - we need you! 

HOW TO REPORT A BUG 

We use the a software called Trac' for reporting and managing bug reports. To contribute you 
must first create an account. You create an account on the Booki Bug Tracking (Trac) site at 
the following URL: 

http://booki-dev.flossmanuals.net/register 

Once you have done that you will need to open a new 'ticket'. In this instance a 'ticket' is just 
another word for 'bug report'. You can click on the 'New Ticket' link located at the top right of 
any page in Trac. If you don't see this link then you are probably not logged in. 

You will see a form with several fields : 



Here are some tips on what to put in each field: 

Summary - give a brief summary of the bug in no more than a dozen words. Keep it brief and 
descriptive. This in itself is an art! 

Reporter - this should automatically display your name and you should not alter this 
information. 

Description - describe the bug in much detail as possible. Be as specific as possible and 
provide information so that the developers can recreate the same error if possible. Don't 
worry about supplying too much information - put in here as much as you like. Additionally, if 
the bug has displayed an error message, copy and paste the entire message at the end of the 
description. 

Type - leave this as 'defect' (bug). 

Milestone - leave this as 'Bugs'. 
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Keywords - add a few keywords to help people find all bugs related to a specific topic using 
the search system in Trac. You could use keywords like 'registration' if the bug was found 
during the registration process, 'editing' if the bug while discovered while editing a book etc. 
You can provide many keywords but make sure they are all separated by a comma 

Assign to - leave this blank (used by the developers) 

Priority - you can set this as you like, probably someone will come by later (the 'bug 
manager') and set the priority level again. 

Component - probably you will want to leave this set as 'Booki'. Only if you are testing Objavi 
(the publishing engine) will you need to set this as Objavi. 

Cc - leave this as it is displayed. If you wish to be informed of any changes to this bug report 
then add your Trac username and the end of this list preceded by a blank space. 

Once all is filled out press 'Create ticket'. ..now pat yourself on the back and find more bugs to 
report! 
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